Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions That Modify Movie Properties / Working With Track Time

SetTrackOffset

The SetTrackOffset function modifies the duration of the empty space that lies at the beginning of the track, thus changing the duration of the entire track. You specify this time offset as a time value in the movie's time scale. See Figure 2-6 on page 2-10 for an illustration of a track offset in a movie.

pascal void SetTrackOffset (Track theTrack, 
                            TimeValue movieOffsetTime);

theTrack

Specifies the track for this operation. Your application obtains this track identifier from such Movie Toolbox functions as NewMovieTrack and GetMovieTrack (described on page 2-136 and page 2-188, respectively).

movieOffsetTime

Specifies the track's offset from the start of the movie, and must be expressed in the time scale of the movie that contains the track.

ERROR CODES

invalidTrack

-2009

This track is corrupted or invalid

SEE ALSO

You can determine a track's time offset by calling the GetTrackOffset function, which is described in the next section.